NewEmptyHandleSys

Create a NIL handle (don't allocate any space)

#include <Memory.h> Memory Manager

returns a handle pointing to a NIL master pointer

NewEmptyHandle creates a new handle, but does not allocate any memory

(even a 0-length allocation uses memory for a block header). It is equivalent

to a two-step series NewHandle, followed by EmptyHandle.

Returns: a valid, though empty handle; it is the address of a NIL master

pointer.

Notes: There is another routine, NewEmptyHandleSys, which performs the

equivalent operation to NewEmptyHandle, but in the System heap zone. It

takes the same parameters as NewEmptyHandle.

Referenced by (3):